home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 1 / ShareWare Extravaganza 1 of 4 (The Ultimate Shareware Company).iso / grprogs / cinema10.exe / CINEDRVR.DOC < prev    next >
Text File  |  1990-07-06  |  7KB  |  148 lines
  1.  
  2. Super VGA card drivers for Cinema
  3. ___________________________________________
  4.  
  5. NOTE: The super VGA drivers provided with Cinema are identical to 
  6. the ones used with Graphic Workshop, another program by Alchemy 
  7. Mindworks Inc. The other drivers included with this package - 
  8. CGA.DRV and HERC.DRV - are not compatible with Graphic Workshop, 
  9. and will not load into it.
  10.  
  11. The following drivers are provided with this version of Cinema. 
  12. If you have an EGA only system, use GRAFDRV.DRV and be sure not 
  13. to include any files with more than 16 colours in your Cinema 
  14. programs.
  15.  
  16. TRIDENT.DRV    This is a driver for the Trident VGA graphic 
  17.                 cards. It drives the card in its 640 by 400, 256 
  18.                 colour mode, and will work with cards having 256 
  19.                 kilobytes or more of onboard memory. We 
  20.                 originally found the Trident card this driver was 
  21.                 developed on in a Sun Moon Star 386SX we were 
  22.                 loaned. It turned out that the monitor provided 
  23.                 with this computer would not sync in the 640 by 
  24.                 400 256 colour mode, even though the card was 
  25.                 doing fine. If you have this system, you probably 
  26.                 won't be able to use this driver unless you 
  27.                 spring for a multisync monitor.
  28.  
  29. VIDEO7.DRV    This is a driver for the Headland Technologies 
  30.                 Video Seven VRAM and Video Seven 1024i cards. It 
  31.                 supports the 640 by 480 line 256-colour mode. It 
  32.                 uses the standard VGA and EGA 16-colour and 
  33.                 monochrome modes... we decided not to implement 
  34.                 the 1024 by 768 16-colour mode. There are very 
  35.                 few 16-colour images around which could take 
  36.                 advantage of this mode, but there are a lot of 
  37.                 monitors which cannot.
  38.  
  39. PARAPLUS.DRV    This is a full featured driver for the Western 
  40.                 Digital Paradise Plus card. This driver also 
  41.                 works with the Dell Super VGA card, which is 
  42.                 actually a Paradise 16-bit card.
  43.  
  44. DELLVGA.DRV    This is a version of PARAPLUS.DRV, above. It has 
  45.                 been modified not to use the 800 by 600 pixel EGA 
  46.                 and monochrome modes of the Paradise card, as 
  47.                 this causes the super VGA monitor on a Dell to 
  48.                 click a (loud) internal relay every time it 
  49.                 changes modes. If you don't mind the relay, or 
  50.                 you want the 800 by 600 modes, use PARAPLUS.DRV, 
  51.                 above.
  52.  
  53.                 Note: rumour has it that some Dell systems have 
  54.                 been shipped with Headland Video 7 cards rather 
  55.                 than Paradise cards. If your Dell system is so 
  56.                 equipped... or if you can't get GWS to work in 
  57.                 the super VGA modes with one of the above two 
  58.                 drivers... try VIDEO7.DRV.
  59.  
  60. ATIWONDR.DRV    This is a driver for the ATI VGA Wonder and ATI 
  61.                 VGA Edge cards. It drives the 256 colour screen 
  62.                 in the 400 line mode, and will work with cards 
  63.                 having 256K on them. The upper 256K on half meg 
  64.                 cards will be ignored by this driver.
  65.  
  66. ATI512.DRV    This is a driver for ATI Wonder cards having 512K 
  67.                 of memory on board. It will display pictures in 
  68.                 up to 800 by 600 pixel resolution, selecting 
  69.                 among the three available 256 colour display 
  70.                 modes based on the dimensions of the image to be 
  71.                 viewed.
  72.         
  73. GRAFDRV.DRV    This is a stock VGA card driver. You might want 
  74.                 to use this if there is no super VGA card driver 
  75.                 available for your card, however, as it handles 
  76.                 the 16-colour and monochrome modes in potentially 
  77.                 more useful ways than the internal VGA driver of 
  78.                 Graphic Workshop does. 
  79.  
  80. VGA400.DRV    This is a "gadget" driver for a stock VGA card 
  81.                 which reprograms the beast into an undocumented 
  82.                 320 by 400 line mode. It should work on any VGA 
  83.                 card, but being undocumented one cannot be sure. 
  84.                 In any case, while interesting, this mode has 
  85.                 such a squashed aspect ratio that it's not really 
  86.                 useful for anything. In addition, having heavily 
  87.                 interlaced memory, it's painfully slow to update.
  88.  
  89. VGA480.DRV    This is another undocumented mode. It gets still 
  90.                 more on the screen, with still more distortion.
  91.  
  92. To use one of these drivers with Cinema, place an OpenDriver 
  93. command with a path to the appropriate .DRV file at the beginning 
  94. of each Cinema program you write.
  95.  
  96.  
  97. Writing your own driver
  98.  
  99. Also included with this version of Cinema is GRAFDRV.ASM, the 
  100. source code for GRAFDRV.DRV. This file can be used as the 
  101. boilerplate for writing your own super VGA card driver. You will 
  102. need a pretty good grasp of assembly language and the hardware 
  103. specific details of the card you want to write a driver for to 
  104. get this together. This file should be assembled with Microsoft's 
  105. MASM assembler, version 4.0 or better.
  106.     The following batch file is useful in assembling 
  107. GRAFDRV.ASM into GRAFDRV.DRV... or any other driver you happen to 
  108. write.
  109.  
  110. MASM %1 %1 NUL NUL
  111. IF ERRORLEVEL 1 GOTO PROBLEM
  112. LINK %1 @AUTOLINK
  113. EXE2BIN %1 %1.DRV
  114. DEL %1.EXE
  115. DEL %1.OBJ
  116. :PROBLEM
  117.  
  118.     The file AUTOLINK must be present... it contains four 
  119. carriage returns, that is, four blank lines.
  120.     In future releases we hope to include a number of SVGA 
  121. drivers with Cinema and Graphic Workshop. If you write one using 
  122. the GRAFDRV.ASM skeletal driver and care to send us the source, 
  123. we'll be pleased to include it with future releases, with 
  124. suitable credit.
  125.     Registered users of Graphic Workshop or Cinema who want 
  126. to write their own drivers are welcome to the source code for all 
  127. the above drivers... you might find some of the techniques used 
  128. in them helpful in writing your driver. The only conditions are 
  129. that you must be a registered user and we'd like to have the 
  130. source code for the driver you write when you get it working... 
  131. we'll include the object file in with future releases of Cinema 
  132. and Graphic Workshop.
  133.     We'll be happy to give you whatever help we can in 
  134. writing your driver, too.
  135.     If you want the driver source files, please phone or 
  136. write us and we'll send 'em off to you.
  137.  
  138.  
  139. Custom drivers
  140.  
  141. We've been asked on a few occasions whether we'll write custom 
  142. drivers for Graphic Workshop and Cinema on behalf of various 
  143. interested parties. We might be able to, depending on time and 
  144. whathaveyou. If you really want a specific SVGA driver for one of 
  145. our packages... for example, if you want to licence it for 
  146. inclusion with a particular card or computer... and you can't get 
  147. it together yourself, contact us. Our address is in CINEMA.DOC.
  148.